home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / sound / watch.zip / NOTES.DOC < prev    next >
Text File  |  1990-12-27  |  6KB  |  184 lines
  1.  
  2. FM Software 12/90 update -- Implementation notes
  3. ================================================
  4.  
  5. Changes have been made to all of the FM Software packages since
  6. the June 1990 release.  Note especially that extensive MIDI
  7. driver modifications have resulted in new command line options. 
  8. If you used any command line options in previous releases, be
  9. sure to check the "Command Line Changes" section below for new
  10. formats before running any of the revised programs.
  11.  
  12. This document covers all available packages and some sections may
  13. not apply to the distribution you have received.  
  14.  
  15.  
  16. New MIDI Drivers
  17. ----------------
  18.  
  19. The MIDI device interface code has been completely rewritten for
  20. this release.  Support has been added for the Key Electronics
  21. MIDIator and the Creative Labs SOUND BLASTER (with MIDI adapter). 
  22. A universal MIDI driver is employed which allows each program to
  23. operate with any of the supported interfaces.  Default device
  24. selection can be overridden on the command line for systems using
  25. multiple interfaces.  All I/O is now interrupt-driven by default,
  26. rather than via polled access (the previous default). 
  27.  
  28.  
  29. New Programs
  30. ------------
  31.  
  32. * Play/R -- Memory resident MIDI file player.
  33.   See PLAYR.DOC for details if this program has been included
  34.   with your distribution.
  35.  
  36. * FM2MDX -- FM-Edit to MIDIEX bank converter.
  37.  
  38. * Play/B -- Batch Play version (non-interactive).
  39.   Replaces Play15.
  40.  
  41.  
  42. Help - All interactive programs
  43. -------------------------------
  44.  
  45. * String search speed has been improved.
  46.  
  47. * Search words can now be selected from the text using a mouse.
  48.  
  49.  
  50. Watch program
  51. -------------
  52.  
  53. * The Alt-0 send key has been modified to ask for the send string
  54.   each time it is pressed.  This permits quicker entry of strings
  55.   while on the Monitor screen.
  56.  
  57. * The available buffer memory has been increased to approx. 80K
  58.   bytes.  The size of MIDI files loaded is now only limited by
  59.   the amount of free memory.
  60.  
  61.  
  62. Play program
  63. ------------
  64.  
  65. * Play list support has been added for continuous, automatic
  66.   play.
  67.  
  68. * Function keys and mouse selectors have been altered due to new
  69.   functions associated with play lists.  Check the help screen
  70.   for the new definitions.
  71.  
  72. * Files are now sorted alphabetically in the file list display,   
  73.   and play lists can be created by selecting files from that
  74.   display.
  75.  
  76. * There is now a meter display mode available (Alt-F6) which
  77.   shows song length and position in measures and beats.  Time
  78.   signature is also shown in this mode.  The time display is now
  79.   more consistent when advancing.
  80.  
  81. * A delay between songs in a play list can be specified using the 
  82.   -w option on the command line.
  83.  
  84. * MIDI file size is now only limited by the amount of available
  85.   memory.
  86.  
  87.  
  88. File extensions
  89. ---------------
  90.  
  91. * Programs which read MIDI files will now check for any of the  
  92.   following extensions if none is specified: .mff, .mid, .std, 
  93.   .smf.
  94.  
  95. * The default extension (.mff) for wildcard directories searches
  96.   can be changed via the mff environment variable.  
  97.   Ex: set mff=mid
  98.  
  99.  
  100. Command Line Changes
  101. --------------------
  102.  
  103. All programs which do MIDI input/output now use the "-d" option
  104. to select the active device (if more than one is present):
  105.  
  106.        -dmfc      selects IBM Music Feature
  107.        -dmpu      selects MPU-401 compatible
  108.        -dmidiator selects MIDIator
  109.        -dsbmidi   selects Sound Blaster MIDI
  110.  
  111.        (The first 3 letters of the device name are sufficient.)
  112.  
  113.      Optional IRQ and I/O port address information can be added
  114.      following the device id if necessary:
  115.  
  116.               -dxxx:<irq>:<ioaddr>
  117.  
  118.      For example, to define an MPU-compatible interface using IRQ
  119.      5 and I/O address 332 (hex), use:
  120.  
  121.               -dMPU:5:332
  122.  
  123.      If only the I/O address is required but the default IRQ is
  124.      alright, use -dMPU::332.
  125.  
  126. Other new options include "-i" which will try to determine the
  127. IRQ in use automatically (MPU and MFC only), "-v" which lists
  128. the type of interface actually selected before starting, and
  129. "-s" which doubles the size of the MIDI input buffer.
  130.  
  131. Command line options (those beginning with "-") may be set
  132. permanently by including DOS environment variable definitions in
  133. your autoexec.bat file.  Use the variables opt1, opt2, opt3, and
  134. so on.  Be to include the "-" character before the option letter. 
  135. For example, "set opt1=-dmpu:5:332".  This has the same effect as
  136. including the -d option described above on each command.
  137.  
  138.  
  139. Device restrictions
  140. -------------------
  141.  
  142. MIDIator
  143.  
  144. With the current drivers, the MIDIator is not automatically
  145. detected as are the other device types.  The -dmid option must
  146. always be specified on any of the program command lines to
  147. utilize this device.  This can be set by default by defining an
  148. environment variable before use (usually in the autoexec.bat
  149. file):
  150.                    set opt1=-dmid
  151.  
  152.  
  153. SOUND BLASTER
  154.  
  155. Technically, the SOUND BLASTER uses a half-duplex MIDI
  156. implementation, meaning that it cannot simultaneously send and
  157. receive MIDI data.  The MIDI driver "simulates" full-duplex
  158. operation by rapidly switching between input and output modes.
  159. This is not 100% effective, however, and some input data may
  160. be lost during "thru" operations.  In particular, the
  161. thru/patchbay operations in the Watch program may not prove
  162. useful, depending on the amount of data being received.  Thru
  163. operations are disabled entirely if not using interrupt-driven
  164. mode (i.e., -dsbm:0 is specified on the command line indicating
  165. no interrupt).  Because of the i/o restriction, the FM-Tune
  166. program will also not operate correctly and so is not supported
  167. for use with the SOUND BLASTER. 
  168.  
  169.  
  170. Questions
  171. ---------
  172.  
  173. Questions or problems regarding this software should be addressed to:
  174.  
  175.     Kevin Weiner
  176.     FM Software
  177.     1413 Spring St.
  178.     Bethlehem, PA 18018
  179.  
  180.     (215) 865-7956
  181.  
  182.     CompuServe: 72416,2465
  183.     BIX or PAN: KWEINER 
  184.